<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>equ_histo_image_rect [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_filters.html">过滤器</a> / <a href="toc_filters_enhancement.html">Enhancement</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">equ_histo_image_rect</span><span data-if="c" style="display:none;">equ_histo_image_rect</span><span data-if="cpp" style="display:none;">EquHistoImageRect</span><span data-if="dotnet" style="display:none;">EquHistoImageRect</span><span data-if="python" style="display:none;">equ_histo_image_rect</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">equ_histo_image_rect</span><span data-if="c" style="display:none;">equ_histo_image_rect</span><span data-if="cpp" style="display:none;">EquHistoImageRect</span><span data-if="dotnet" style="display:none;">EquHistoImageRect</span><span data-if="python" style="display:none;">equ_histo_image_rect</span></code> — Histogram linearization within a rectangluar mask.</p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>equ_histo_image_rect</b>(<a href="#Image"><i>Image</i></a> : <a href="#ImageEquHisto"><i>ImageEquHisto</i></a> : <a href="#Mode"><i>Mode</i></a>, <a href="#MaskWidth"><i>MaskWidth</i></a>, <a href="#MaskHeight"><i>MaskHeight</i></a>, <a href="#MaxContrast"><i>MaxContrast</i></a> : )</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>equ_histo_image_rect</b>(const Hobject <a href="#Image"><i>Image</i></a>, Hobject* <a href="#ImageEquHisto"><i>ImageEquHisto</i></a>, const char* <a href="#Mode"><i>Mode</i></a>, const Hlong <a href="#MaskWidth"><i>MaskWidth</i></a>, const Hlong <a href="#MaskHeight"><i>MaskHeight</i></a>, double <a href="#MaxContrast"><i>MaxContrast</i></a>)</code></p>
<p>
<code>Herror <b>T_equ_histo_image_rect</b>(const Hobject <a href="#Image"><i>Image</i></a>, Hobject* <a href="#ImageEquHisto"><i>ImageEquHisto</i></a>, const Htuple <a href="#Mode"><i>Mode</i></a>, const Htuple <a href="#MaskWidth"><i>MaskWidth</i></a>, const Htuple <a href="#MaskHeight"><i>MaskHeight</i></a>, const Htuple <a href="#MaxContrast"><i>MaxContrast</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>EquHistoImageRect</b>(const HObject&amp; <a href="#Image"><i>Image</i></a>, HObject* <a href="#ImageEquHisto"><i>ImageEquHisto</i></a>, const HTuple&amp; <a href="#Mode"><i>Mode</i></a>, const HTuple&amp; <a href="#MaskWidth"><i>MaskWidth</i></a>, const HTuple&amp; <a href="#MaskHeight"><i>MaskHeight</i></a>, const HTuple&amp; <a href="#MaxContrast"><i>MaxContrast</i></a>)</code></p>
<p>
<code><a href="HImage.html">HImage</a> <a href="HImage.html">HImage</a>::<b>EquHistoImageRect</b>(const HString&amp; <a href="#Mode"><i>Mode</i></a>, Hlong <a href="#MaskWidth"><i>MaskWidth</i></a>, Hlong <a href="#MaskHeight"><i>MaskHeight</i></a>, const HTuple&amp; <a href="#MaxContrast"><i>MaxContrast</i></a>) const</code></p>
<p>
<code><a href="HImage.html">HImage</a> <a href="HImage.html">HImage</a>::<b>EquHistoImageRect</b>(const HString&amp; <a href="#Mode"><i>Mode</i></a>, Hlong <a href="#MaskWidth"><i>MaskWidth</i></a>, Hlong <a href="#MaskHeight"><i>MaskHeight</i></a>, double <a href="#MaxContrast"><i>MaxContrast</i></a>) const</code></p>
<p>
<code><a href="HImage.html">HImage</a> <a href="HImage.html">HImage</a>::<b>EquHistoImageRect</b>(const char* <a href="#Mode"><i>Mode</i></a>, Hlong <a href="#MaskWidth"><i>MaskWidth</i></a>, Hlong <a href="#MaskHeight"><i>MaskHeight</i></a>, double <a href="#MaxContrast"><i>MaxContrast</i></a>) const</code></p>
<p>
<code><a href="HImage.html">HImage</a> <a href="HImage.html">HImage</a>::<b>EquHistoImageRect</b>(const wchar_t* <a href="#Mode"><i>Mode</i></a>, Hlong <a href="#MaskWidth"><i>MaskWidth</i></a>, Hlong <a href="#MaskHeight"><i>MaskHeight</i></a>, double <a href="#MaxContrast"><i>MaxContrast</i></a>) const  <span class="signnote">
            (
            Windows only)
          </span></code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>EquHistoImageRect</b>(<a href="HObject.html">HObject</a> <a href="#Image"><i>image</i></a>, out <a href="HObject.html">HObject</a> <a href="#ImageEquHisto"><i>imageEquHisto</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Mode"><i>mode</i></a>, <a href="HTuple.html">HTuple</a> <a href="#MaskWidth"><i>maskWidth</i></a>, <a href="HTuple.html">HTuple</a> <a href="#MaskHeight"><i>maskHeight</i></a>, <a href="HTuple.html">HTuple</a> <a href="#MaxContrast"><i>maxContrast</i></a>)</code></p>
<p>
<code><a href="HImage.html">HImage</a> <a href="HImage.html">HImage</a>.<b>EquHistoImageRect</b>(string <a href="#Mode"><i>mode</i></a>, int <a href="#MaskWidth"><i>maskWidth</i></a>, int <a href="#MaskHeight"><i>maskHeight</i></a>, <a href="HTuple.html">HTuple</a> <a href="#MaxContrast"><i>maxContrast</i></a>)</code></p>
<p>
<code><a href="HImage.html">HImage</a> <a href="HImage.html">HImage</a>.<b>EquHistoImageRect</b>(string <a href="#Mode"><i>mode</i></a>, int <a href="#MaskWidth"><i>maskWidth</i></a>, int <a href="#MaskHeight"><i>maskHeight</i></a>, double <a href="#MaxContrast"><i>maxContrast</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>equ_histo_image_rect</b>(<a href="#Image"><i>image</i></a>: HObject, <a href="#Mode"><i>mode</i></a>: str, <a href="#MaskWidth"><i>mask_width</i></a>: int, <a href="#MaskHeight"><i>mask_height</i></a>: int, <a href="#MaxContrast"><i>max_contrast</i></a>: Union[float, int]) -&gt; HObject</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p>该算子 <code><span data-if="hdevelop" style="display:inline">equ_histo_image_rect</span><span data-if="c" style="display:none">equ_histo_image_rect</span><span data-if="cpp" style="display:none">EquHistoImageRect</span><span data-if="com" style="display:none">EquHistoImageRect</span><span data-if="dotnet" style="display:none">EquHistoImageRect</span><span data-if="python" style="display:none">equ_histo_image_rect</span></code> enhances the contrast.
Similar to <a href="equ_histo_image.html"><code><span data-if="hdevelop" style="display:inline">equ_histo_image</span><span data-if="c" style="display:none">equ_histo_image</span><span data-if="cpp" style="display:none">EquHistoImage</span><span data-if="com" style="display:none">EquHistoImage</span><span data-if="dotnet" style="display:none">EquHistoImage</span><span data-if="python" style="display:none">equ_histo_image</span></code></a>, it applies a transformation to linearize
the cumulative histogram. However, instead of using the histogram of the
whole image, only the local neighborhood of each pixel is considered to
compute the transformation. The size of this rectangular neighborhood region
can be set by <a href="#MaskWidth"><i><code><span data-if="hdevelop" style="display:inline">MaskWidth</span><span data-if="c" style="display:none">MaskWidth</span><span data-if="cpp" style="display:none">MaskWidth</span><span data-if="com" style="display:none">MaskWidth</span><span data-if="dotnet" style="display:none">maskWidth</span><span data-if="python" style="display:none">mask_width</span></code></i></a> and <a href="#MaskHeight"><i><code><span data-if="hdevelop" style="display:inline">MaskHeight</span><span data-if="c" style="display:none">MaskHeight</span><span data-if="cpp" style="display:none">MaskHeight</span><span data-if="com" style="display:none">MaskHeight</span><span data-if="dotnet" style="display:none">maskHeight</span><span data-if="python" style="display:none">mask_height</span></code></i></a>.
</p>
<p>The local contrast maximization improves the visibility of low-contrast
structures, but also amplifies noise. The parameter <a href="#MaxContrast"><i><code><span data-if="hdevelop" style="display:inline">MaxContrast</span><span data-if="c" style="display:none">MaxContrast</span><span data-if="cpp" style="display:none">MaxContrast</span><span data-if="com" style="display:none">MaxContrast</span><span data-if="dotnet" style="display:none">maxContrast</span><span data-if="python" style="display:none">max_contrast</span></code></i></a> can
be used to limit the maximum contrast in a local neighborhood, which
effectively reduces the amplification of noise. Therefore, the method is also
known as Contrast-Limited Adaptive Histogram Equalization (CLAHE).
</p>
<p>The parameter <a href="#Mode"><i><code><span data-if="hdevelop" style="display:inline">Mode</span><span data-if="c" style="display:none">Mode</span><span data-if="cpp" style="display:none">Mode</span><span data-if="com" style="display:none">Mode</span><span data-if="dotnet" style="display:none">mode</span><span data-if="python" style="display:none">mode</span></code></i></a> determines the processing mode.
In the <i><span data-if="hdevelop" style="display:inline">'accurate'</span><span data-if="c" style="display:none">"accurate"</span><span data-if="cpp" style="display:none">"accurate"</span><span data-if="com" style="display:none">"accurate"</span><span data-if="dotnet" style="display:none">"accurate"</span><span data-if="python" style="display:none">"accurate"</span></i> mode, the transformation is computed for each
pixel as described above.
In the <i><span data-if="hdevelop" style="display:inline">'fast'</span><span data-if="c" style="display:none">"fast"</span><span data-if="cpp" style="display:none">"fast"</span><span data-if="com" style="display:none">"fast"</span><span data-if="dotnet" style="display:none">"fast"</span><span data-if="python" style="display:none">"fast"</span></i> mode, the transformation is computed only for a subset
of all pixels and interpolated between those points.
Due to the interpolation, the results of both modes can differ significantly.
</p>
<h2 id="sec_attention">注意</h2>
<p>该算子 <code><span data-if="hdevelop" style="display:inline">equ_histo_image_rect</span><span data-if="c" style="display:none">equ_histo_image_rect</span><span data-if="cpp" style="display:none">EquHistoImageRect</span><span data-if="com" style="display:none">EquHistoImageRect</span><span data-if="dotnet" style="display:none">EquHistoImageRect</span><span data-if="python" style="display:none">equ_histo_image_rect</span></code> primarily serves for
optical processing of images for a human viewer. For example, the
contrast spreading can lead to a detection of fictitious edges.
</p>
<p>Note that filter operators may return unexpected results if
an image with a reduced domain is used as input. Please refer to the
chapter <a href="toc_filters.html">过滤器</a>.</p>
<h2 id="sec_execution">运行信息</h2>
<ul>
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  
    <li>在元组级别自动并行化。</li>
    <li>在图像通道级别自动并行化。</li>
    <li>Automatically parallelized on  domain level.</li>
  
</ul>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="Image" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Image</span><span data-if="c" style="display:none">Image</span><span data-if="cpp" style="display:none">Image</span><span data-if="com" style="display:none">Image</span><span data-if="dotnet" style="display:none">image</span><span data-if="python" style="display:none">image</span></code></b> (input_object)  </span><span>(multichannel-)image(-array) <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="c" style="display:none">Hobject</span> (byte)</span>
</div>
<p class="pardesc">Image to be enhanced.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="ImageEquHisto" class="parname"><b><code><span data-if="hdevelop" style="display:inline">ImageEquHisto</span><span data-if="c" style="display:none">ImageEquHisto</span><span data-if="cpp" style="display:none">ImageEquHisto</span><span data-if="com" style="display:none">ImageEquHisto</span><span data-if="dotnet" style="display:none">imageEquHisto</span><span data-if="python" style="display:none">image_equ_histo</span></code></b> (output_object)  </span><span>(multichannel-)image(-array) <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="c" style="display:none">Hobject *</span> (byte)</span>
</div>
<p class="pardesc">Image with linearized gray values.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Mode" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Mode</span><span data-if="c" style="display:none">Mode</span><span data-if="cpp" style="display:none">Mode</span><span data-if="com" style="display:none">Mode</span><span data-if="dotnet" style="display:none">mode</span><span data-if="python" style="display:none">mode</span></code></b> (input_control)  </span><span>string <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">str</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Processing mode.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'accurate'</span>
    <span data-if="c" style="display:none">"accurate"</span>
    <span data-if="cpp" style="display:none">"accurate"</span>
    <span data-if="com" style="display:none">"accurate"</span>
    <span data-if="dotnet" style="display:none">"accurate"</span>
    <span data-if="python" style="display:none">"accurate"</span>
</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span><span data-if="hdevelop" style="display:inline">'accurate'</span><span data-if="c" style="display:none">"accurate"</span><span data-if="cpp" style="display:none">"accurate"</span><span data-if="com" style="display:none">"accurate"</span><span data-if="dotnet" style="display:none">"accurate"</span><span data-if="python" style="display:none">"accurate"</span>, <span data-if="hdevelop" style="display:inline">'fast'</span><span data-if="c" style="display:none">"fast"</span><span data-if="cpp" style="display:none">"fast"</span><span data-if="com" style="display:none">"fast"</span><span data-if="dotnet" style="display:none">"fast"</span><span data-if="python" style="display:none">"fast"</span></p>
</div>
  <div class="par">
<div class="parhead">
<span id="MaskWidth" class="parname"><b><code><span data-if="hdevelop" style="display:inline">MaskWidth</span><span data-if="c" style="display:none">MaskWidth</span><span data-if="cpp" style="display:none">MaskWidth</span><span data-if="com" style="display:none">MaskWidth</span><span data-if="dotnet" style="display:none">maskWidth</span><span data-if="python" style="display:none">mask_width</span></code></b> (input_control)  </span><span>extent.x <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Width of the filter mask.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>51</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>31, 51, 101, 151</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>1
          ≤
        
    <span data-if="hdevelop" style="display:inline">MaskWidth</span>
    <span data-if="c" style="display:none">MaskWidth</span>
    <span data-if="cpp" style="display:none">MaskWidth</span>
    <span data-if="com" style="display:none">MaskWidth</span>
    <span data-if="dotnet" style="display:none">maskWidth</span>
    <span data-if="python" style="display:none">mask_width</span>
    </code></p>
<p class="pardesc"><span class="parcat">Minimum increment:
      </span>2</p>
<p class="pardesc"><span class="parcat">Restriction:
      </span><code>MaskWidth &lt;= width(Image)</code></p>
</div>
  <div class="par">
<div class="parhead">
<span id="MaskHeight" class="parname"><b><code><span data-if="hdevelop" style="display:inline">MaskHeight</span><span data-if="c" style="display:none">MaskHeight</span><span data-if="cpp" style="display:none">MaskHeight</span><span data-if="com" style="display:none">MaskHeight</span><span data-if="dotnet" style="display:none">maskHeight</span><span data-if="python" style="display:none">mask_height</span></code></b> (input_control)  </span><span>extent.y <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Height of the filter mask.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>51</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>31, 51, 101, 151</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>1
          ≤
        
    <span data-if="hdevelop" style="display:inline">MaskHeight</span>
    <span data-if="c" style="display:none">MaskHeight</span>
    <span data-if="cpp" style="display:none">MaskHeight</span>
    <span data-if="com" style="display:none">MaskHeight</span>
    <span data-if="dotnet" style="display:none">maskHeight</span>
    <span data-if="python" style="display:none">mask_height</span>
    </code></p>
<p class="pardesc"><span class="parcat">Minimum increment:
      </span>2</p>
<p class="pardesc"><span class="parcat">Restriction:
      </span><code>MaskHeight &lt;= height(Image)</code></p>
</div>
  <div class="par">
<div class="parhead">
<span id="MaxContrast" class="parname"><b><code><span data-if="hdevelop" style="display:inline">MaxContrast</span><span data-if="c" style="display:none">MaxContrast</span><span data-if="cpp" style="display:none">MaxContrast</span><span data-if="com" style="display:none">MaxContrast</span><span data-if="dotnet" style="display:none">maxContrast</span><span data-if="python" style="display:none">max_contrast</span></code></b> (input_control)  </span><span>real <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Union[float, int]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (real / </span><span data-if="hdevelop" style="display:inline">integer)</span><span data-if="dotnet" style="display:none"> (<i>double</i> / </span><span data-if="dotnet" style="display:none">int / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>double</i> / </span><span data-if="cpp" style="display:none">Hlong)</span><span data-if="c" style="display:none"> (<i>double</i> / </span><span data-if="c" style="display:none">Hlong)</span></span>
</div>
<p class="pardesc">Maximum contrast.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>0.01</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>0, 0.01, 0.02, 0.05, 0.1, 0.5, 1</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>0
          ≤
        
    <span data-if="hdevelop" style="display:inline">MaxContrast</span>
    <span data-if="c" style="display:none">MaxContrast</span>
    <span data-if="cpp" style="display:none">MaxContrast</span>
    <span data-if="com" style="display:none">MaxContrast</span>
    <span data-if="dotnet" style="display:none">maxContrast</span>
    <span data-if="python" style="display:none">max_contrast</span>
    
          ≤
          1</code></p>
</div>
<h2 id="sec_complexity">Complexity</h2>
<p>In <a href="#Mode"><i><code><span data-if="hdevelop" style="display:inline">Mode</span><span data-if="c" style="display:none">Mode</span><span data-if="cpp" style="display:none">Mode</span><span data-if="com" style="display:none">Mode</span><span data-if="dotnet" style="display:none">mode</span><span data-if="python" style="display:none">mode</span></code></i></a>=<i><span data-if="hdevelop" style="display:inline">'accurate'</span><span data-if="c" style="display:none">"accurate"</span><span data-if="cpp" style="display:none">"accurate"</span><span data-if="com" style="display:none">"accurate"</span><span data-if="dotnet" style="display:none">"accurate"</span><span data-if="python" style="display:none">"accurate"</span></i>, <code><span data-if="hdevelop" style="display:inline">equ_histo_image_rect</span><span data-if="c" style="display:none">equ_histo_image_rect</span><span data-if="cpp" style="display:none">EquHistoImageRect</span><span data-if="com" style="display:none">EquHistoImageRect</span><span data-if="dotnet" style="display:none">EquHistoImageRect</span><span data-if="python" style="display:none">equ_histo_image_rect</span></code> uses an
algorithm with constant complexity per pixel, i.e., the runtime only depends
on the size of the input image and not on the mask size.
</p>
<p>In <a href="#Mode"><i><code><span data-if="hdevelop" style="display:inline">Mode</span><span data-if="c" style="display:none">Mode</span><span data-if="cpp" style="display:none">Mode</span><span data-if="com" style="display:none">Mode</span><span data-if="dotnet" style="display:none">mode</span><span data-if="python" style="display:none">mode</span></code></i></a>=<i><span data-if="hdevelop" style="display:inline">'fast'</span><span data-if="c" style="display:none">"fast"</span><span data-if="cpp" style="display:none">"fast"</span><span data-if="com" style="display:none">"fast"</span><span data-if="dotnet" style="display:none">"fast"</span><span data-if="python" style="display:none">"fast"</span></i>, the number of histograms to be computed
depends on the mask size. Hence, the runtime increases with smaller mask
sizes and decreases with larger mask sizes.
</p>
<h2 id="sec_successors">可能的后置算子</h2>
<p>
<code><a href="disp_image.html"><span data-if="hdevelop" style="display:inline">disp_image</span><span data-if="c" style="display:none">disp_image</span><span data-if="cpp" style="display:none">DispImage</span><span data-if="com" style="display:none">DispImage</span><span data-if="dotnet" style="display:none">DispImage</span><span data-if="python" style="display:none">disp_image</span></a></code>
</p>
<h2 id="sec_alternatives">可替代算子</h2>
<p>
<code><a href="equ_histo_image.html"><span data-if="hdevelop" style="display:inline">equ_histo_image</span><span data-if="c" style="display:none">equ_histo_image</span><span data-if="cpp" style="display:none">EquHistoImage</span><span data-if="com" style="display:none">EquHistoImage</span><span data-if="dotnet" style="display:none">EquHistoImage</span><span data-if="python" style="display:none">equ_histo_image</span></a></code>, 
<code><a href="scale_image.html"><span data-if="hdevelop" style="display:inline">scale_image</span><span data-if="c" style="display:none">scale_image</span><span data-if="cpp" style="display:none">ScaleImage</span><span data-if="com" style="display:none">ScaleImage</span><span data-if="dotnet" style="display:none">ScaleImage</span><span data-if="python" style="display:none">scale_image</span></a></code>, 
<code><a href="scale_image_max.html"><span data-if="hdevelop" style="display:inline">scale_image_max</span><span data-if="c" style="display:none">scale_image_max</span><span data-if="cpp" style="display:none">ScaleImageMax</span><span data-if="com" style="display:none">ScaleImageMax</span><span data-if="dotnet" style="display:none">ScaleImageMax</span><span data-if="python" style="display:none">scale_image_max</span></a></code>, 
<code><a href="illuminate.html"><span data-if="hdevelop" style="display:inline">illuminate</span><span data-if="c" style="display:none">illuminate</span><span data-if="cpp" style="display:none">Illuminate</span><span data-if="com" style="display:none">Illuminate</span><span data-if="dotnet" style="display:none">Illuminate</span><span data-if="python" style="display:none">illuminate</span></a></code>
</p>
<h2 id="sec_see">参考其它</h2>
<p>
<code><a href="equ_histo_image.html"><span data-if="hdevelop" style="display:inline">equ_histo_image</span><span data-if="c" style="display:none">equ_histo_image</span><span data-if="cpp" style="display:none">EquHistoImage</span><span data-if="com" style="display:none">EquHistoImage</span><span data-if="dotnet" style="display:none">EquHistoImage</span><span data-if="python" style="display:none">equ_histo_image</span></a></code>, 
<code><a href="scale_image.html"><span data-if="hdevelop" style="display:inline">scale_image</span><span data-if="c" style="display:none">scale_image</span><span data-if="cpp" style="display:none">ScaleImage</span><span data-if="com" style="display:none">ScaleImage</span><span data-if="dotnet" style="display:none">ScaleImage</span><span data-if="python" style="display:none">scale_image</span></a></code>
</p>
<h2 id="sec_references">References</h2>
<p>

S. Pizer et al.: “Adaptive Histogram Equalization and Its Variations”.
Computer Vision, Graphics, and Image Processing 39, pp. 355-368, 1987.
</p>
<h2 id="sec_module">模块</h2>
<p>
Foundation</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
